home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / uwwin104.zip / UWWINDOC.TXT < prev    next >
Text File  |  1993-12-14  |  28KB  |  609 lines
  1. 1.0    Introduction
  2.  
  3. This document describes version 1.04 of UW/WIN. This application was designed to run 
  4. on IBM PC and compatible computers running Windows 3.x. Note that standard or 
  5. enhanced mode windows is required, UW/WIN does not run under real mode.
  6.  
  7. This program was inspired by UW/PC, written by Rhys Weatherley. This program is 
  8. entirely independent from UW/PC, and bears no resemblance to UW/PC other than its 
  9. basic functionality. UW in general is based upon a program written for the Apple Macin-
  10. tosh« by John Bruner, and uses the same UW server. It provides for up to seven separate 
  11. login sessions on a remote UNIX machine. A UW server must be running on the remote 
  12. UNIX machine for the advanced features to work. The source code for the UW server is 
  13. available separately as described later in this document.
  14.  
  15. 1.1    Important Note
  16.  
  17. In order to be less "similar" to UW/PC, some of the UW commands have been changed 
  18. from previous versions of UW/WIN. In particular, the "New" command (ALT-N, creates a 
  19. new UW session and windows), has been changed to "Create" (ALT-C). "Kill" (ALT-K, 
  20. kills the current window) has been changed to "Remove" (ALT-R), and "Exit" (ALT-E, 
  21. exits the UW procotol) has been changed to "Protocol 0" (ALT-0).
  22.  
  23. 1.2    Caveats
  24.  
  25. Version 1.04 is the third version released to the public so far, and comments are welcome. 
  26. This version implements the UW protocols 0 and 1. Protocol 0 is a simple dumb terminal 
  27. interface to allow connection to the UNIX host to start up the UW server. Protocol 1 
  28. implements the advanced features described in the document allowing multiple login ses-
  29. sions. The UW server also supports a protocol 2, which has more control over window 
  30. management, however this has not been implemented in UW/WIN. This may be sup-
  31. ported in a future release.
  32.  
  33. Note that the documentation for the server states that it will probably not compile on any-
  34. thing but BSD based UNIX systems (eg SunOS, DEC Ultrix). It will not work on System 
  35. V. There have been difficulties reported under Sys Vr4 as well. There have been reports of 
  36. the server being implemented on VAX/VMS and AIX. Contact the author for details on 
  37. these ports.
  38.  
  39. As was previously mentioned, UW/WIN will run under Windows 3.x standard or 
  40. enhanced mode only. Real mode is not supported. UW/WIN is Windows 3.1 "aware" in 
  41. that it supports the higher baud rates that Windows 3.1 supports and uses the common dia-
  42. log box look and feel from wINDOWS 3.1. If run under Windows 3.0, baud rates above 
  43. 19200 are not allowed, however the common dialog box is still used by virtue of the com-
  44. mdlg.dll file provided with this package.
  45.  
  46. UW/WIN is distributed in the hopes that it will be found useful. If you like the program, a 
  47. contribution os $20 (or whatever you feel the program is worth) would be appreciated and 
  48. will help to insure that enhancements and future products become available. With any con-
  49. tribution, you will receive notification of new versions. With any contribution of $10 or 
  50. more, you will receive this beautiful bound manual. Feel free to distribute this program as 
  51. you wish, so long as the contents, and the notices contained within the archive are not 
  52. changed. Note, however, that the UW server is copyrighted by John Bruner, and is not 
  53. covered under these terms. The UW server has its own terms and conditions contained 
  54. within its documentation. For that reason, the server is not bundled with this package, but 
  55. must be obtained separately.
  56.  
  57. 1.3    Where to get UW/WIN
  58.  
  59. UW/WIN is available on some ftp sites. Most notably it is available from "ftp.cica.indi-
  60. ana.edu" [129.79.20.22] in "pub/pc/win3/util" or its mirror site "wuarchive.wustl.edu" in 
  61. the "mirrors/win3/util". The file name is "uwwin104.zip". Also available alongside is the 
  62. source code for the server as the file "uwserver.zip".
  63.  
  64.  I have been asked why the server source is packaged as a zip file, seeing as how it is 
  65. meant to be unpacked on the UNIX machine. There are a couple of reasons. First is that 
  66. the ftp site where it is located pretty much is standardized on zip. Second, zip seems to 
  67. give superior compression over tar/compress, and it is done in a single operation as 
  68. opposed to tar/compress. Third, "zip" and "unzip" are freely available on UNIX.
  69.  
  70. For those that cannot unzip the server, the source, along with the Macintosh« binaries are 
  71. available from "wuarchive.wustl.edu" as "mirrors/unix-c/macintosh/uw42.tar-z".
  72.  
  73. Also available is a DOS based version written by Rhys Weatherly, "uwpc201.zip" in the 
  74. "mirrors/msdos/modem" directory of "wuarvhive.wustl.edu".
  75.  
  76. 1.4    Authors and Contacts
  77.  
  78. Questions/problems concerning the above mentioned products are welcome.
  79.  
  80. 1.4.1    UW/WIN - Russ Poffenberger
  81.  
  82. Internet :    poffen@San-Jose.ate.slb.com
  83. UUCP :    {uunet,decwrl,amdahl}!sjsca4!poffen
  84. CIS :    72401,276
  85. US Mail :    Russ Poffenberger
  86.     2084 Cypress Point
  87.     Byron, Ca. 94514
  88.  
  89. 1.4.2    UW/PC - Rhys Weatherley
  90.  
  91. Internet :    rhys@cs.uq.oz.au
  92.  
  93. 1.4.3UW Server - John Bruner
  94.  
  95. Arpanet :    jdb@mordor.s1.gov
  96. UUCP :    {lll-crg,decwrl,caip}!mordor!jdb
  97. US Mail :    John Bruner
  98.     Lawerence Livermore National Laboratory
  99.     P.O.Box 5503, L-276
  100.     Livermore, Ca. 94550
  101.  
  102. 1.5    Files
  103.  
  104. The following files make up the entire UW/WIN archive.
  105.  
  106. UWWIN.EXE        The actual Windows 3.x executable.
  107.  
  108. UWLOG.EXE        The executable for the logging module.
  109.  
  110. RZ.EXE        The executable for the X/Y/Zmodem download module.
  111.  
  112. VT100.FON        A set of VT100 fonts that may be used with UW/WIN.
  113.  
  114. FONTREAD.ME        Copyright notice for the VT100.FON file.
  115.  
  116. UWWIN.DOC        The text version of the documentation.
  117.  
  118. DEFAULT.UW        AN example configuration file.
  119.  
  120. README.UWW        Last minute changes and information.
  121.  
  122. HISTORY.UWW        The revision history of UW/WIN.
  123.  
  124. UWWIN.HLP        A windows 3.x compatible online help file.
  125.  
  126. COMMDLG.DLL        Common dialog box for Windows 3.0 users.
  127.  
  128. 2.0    Using UW/WIN.
  129.  
  130. This section describes how to use UW/WIN
  131.  
  132. 2.1    Starting UW/WIN.
  133.  
  134. UW/WIN is started by executing the program "uwwin.exe". Under windows, there are 
  135. several ways that this can be done.
  136.  
  137. From the file manager, simply double-click the file name.
  138.  
  139. From program manager, you may bring down the "File" menu and select "Run". Specify 
  140. the file name "uwwin.exe" if it is on your path, or provide a full path to its location.
  141.  
  142. The best way is to add an icon to one of your program manager groups. You can then start 
  143. UW/WIN simply by double-clicking on the icon.
  144.  
  145. Once started, UW/WIN creates a window with a client area, then brings up the "File | 
  146. Open" dialog box, allowing you to select a configuration file. You may navigate the direc-
  147. tories/disks to find the desired file. Double-clicking the file will load the parameters spec-
  148. ified. You may also select "Cancel" to not load any configuration file, such as might be the 
  149. case for the first time you are running UW/WIN.
  150.  
  151. You may specify the name of a configuration file on the command line. In this case, the 
  152. opening dialog is skipped, and the configuration file is read in directly. This allows you to 
  153. setup file manager associations, or specify the file for the program manager icon using the 
  154. "Properties" dialog of program manager. The latter allows for multiple setups in the case 
  155. that you may have more than one site to contact using UW/WIN.
  156.  
  157. 2.2    Working with UW/WIN.
  158.  
  159. Once you have selected a valid configuration file, or picked a com port to use from the 
  160. "Setup | Comm" menu, UW/WIN enters "protocol 0", which is equivalent to the dumb ter-
  161. minal emulations available in many other communication programs. If a terminal emula-
  162. tion mode is not specified, or changed in the "Setup | Emulation"dialog, then the default 
  163. used is adm31. A number of special keystrokes are available in protocol 0.
  164.  
  165. o    Alt-B    Sends a line break over the serial line.
  166.  
  167. o    Alt-D    Sends the string defined by the "dial" configuration variable to the 
  168. modem. See "Configuring UW/WIN".
  169.  
  170. o    Alt-H    Causes UW/WIN to hangup the modem. First it tries dropping the DTR 
  171. line. If this fails, then the attention string "+++" is sent, followed by the 
  172. hangup string "ATH0".
  173.  
  174. o    Alt-I    This sends the modem initialization string.
  175.  
  176. o    Alt-U    Send the "UW" startup string. Normally it is simply "uw" which will 
  177. execute the UW server on the UNIX host. The UW server must be 
  178. compiled and installed on the UNIX host first.
  179.  
  180. o    Alt-Q    Quit the program. All windows will be destroyed, and UW/WIN will 
  181. exit. You will be prompted before quitting.
  182.  
  183. These functions may also be accessed via the "UW" menu.
  184.  
  185. 2.2.1    Starting the UW Protocol.
  186.  
  187. The purpose of protocol 0 is to allow you to make the inital connection to the UNIX host 
  188. in the normal fashion. When you are ready to use the multiple window mode of UW/WIN, 
  189. you execute the UW server by typing its command name (usuall ÆuwÆ). If the UW com-
  190. mand string has been properly setup, you may press Alt-U, or select from the "UW" menu.
  191.  
  192. When the UW server starts, it uses special characters, embedded within the serial stream 
  193. to begin the protocol with UW/WIN. The current window now becomes window 1. At this 
  194. point, up to six more login windows, each its own separate process, may be started, either 
  195. by using the Alt-C key, or using "UW | Create". Once protocol 1 is started, some of the 
  196. functions under the UW menu become available, while others may become unavailable. 
  197. For functions that are unavailable, pressing their Alt- code has no effect. Under protocol 1, 
  198. the following UW commands are valid.
  199.  
  200. o    Alt-0    Exit the UW session and enter protocol 0. You will be prompted for 
  201. verification first. If you opt to continue with shutdown of protocol 0, 
  202. then all windows (except for window 1) will be destroyed.
  203.  
  204. o    Alt-R    Remove just the currently active window.
  205.  
  206. o    Alt-C    Create a new window. A new login session will be spawned on the 
  207. UNIX host to service it. If there are no more windows available (ie, all 
  208. seven are open), then this command has no effect.
  209.  
  210. o    Alt-n    Where ænÆ is a digit between 1 and 7. This makes window ænÆ the active 
  211. window. All keyboard input is directed to the UNIX process associated 
  212. with that window. Output from other windows will continue to update 
  213. in their respective windows. You may also use the mouse to click in the 
  214. client area, or on the title bar, of any UW window to make it the active 
  215. window.
  216.  
  217. Usually, if you exit the UNIX shell for a window, that window will be removed automati-
  218. cally. If you exit window 1, then ALL other windows will be killed, and UW/WIN will 
  219. return to protocol 0.
  220.  
  221. Each window contains a status bar at the top. This bar contains information about the win-
  222. dow, such as window number, screen size (columns X rows), and which protocol is in 
  223. force. The screen size information is useful to set the UNIX terminal characteristics cor-
  224. rectly (usually using "stty". Refer to your UNIX system documentation for specific infor-
  225. mation.) after changing the window size. When a window is iconified, its title is shortened 
  226. to avoid cluttering your Windows desktop.
  227.  
  228. 2.2.2    Terminal Emulations.
  229.  
  230. There are several adjustments you may want to make to affect the behavior of UW on the 
  231. UNIX system.
  232.  
  233. The UW server usually defaults to using adm31 emulation whenever it creates a new win-
  234. dow. You may wish to use some other form of emulation for your windows. This can be 
  235. accomplished with the following code in your .cshrc if using the bourne shell. This will 
  236. detect if the current TERM entry is adm31, and change it to SS, where SS is the desired 
  237. terminal type.
  238.  
  239.  
  240.  
  241. case $TERM in
  242.     adm31) eval ætset -s SSæ;;
  243. esac
  244.  
  245.  
  246.  
  247. Use the following if you are running csh, or one of its derivatives.
  248.  
  249.  
  250.  
  251. if ($?TERM) then
  252.  
  253.         if ($TERM == adm31) then
  254.  
  255.           unsetenv TERMCAP
  256.  
  257.           setenv TERM vt100
  258.  
  259.         endif
  260.  
  261. endif
  262.  
  263.  
  264.  
  265. You may find it necessary to "unsetenv TERMCAP" on some systems. This is because the 
  266. UW server also places in TERMCAP, a "broken" implementation of a termcap entry for 
  267. adm31. By "broken", I mean that it is minimally functional, and causes problems on some 
  268. systems. Its existence may also interfere with the proper use of the desired emulation. If 
  269. you use adm31, and your system lacks a built-in adm31 emulation, then you may have to 
  270. leave the TERMCAP setting.
  271.  
  272. UW/WIN allows for two different emulations to be used automatically. You may set pro-
  273. tocol 0 emulation (through the "Setup | Emulation" dialog) to be something simple, like 
  274. vt52. When protocol 1 is entered, all windows will then use the emulation specified for 
  275. protocol 1 as defined in the dialog.
  276.  
  277. 2.3    File menu
  278.  
  279. This menu provides access to dialog boxes for saving and loading configuration files, and 
  280. the session logging option.
  281.  
  282. 2.3.1    Loading configuration files.
  283.  
  284. Select "File | Open" to bring up the dialog box which allows you to browse through the 
  285. filesystem, and load a ".UW" configuration file.
  286.  
  287. 2.3.2    Saving configurations.
  288.  
  289. Select "File | Save" to save the current configuration to the same file. Use "File | Save As" 
  290. to select a new file name. See See section 3.0 on page 8 for more information on configu-
  291. ration files.
  292.  
  293. 2.3.3    Logging
  294.  
  295. You may log all screen output (including terminal emulation control characters) to a file 
  296. by selecting the "File | Log" menu item. Upon selecting this option, you will get a dialog 
  297. box allowing you to select the file name to log the characters to. Upon selecting a file, all 
  298. characters that go to that window also go in the file. Selecting "File | Log" again (while it 
  299. is active, a check mark appears next to the menu item), will stop logging and close the file.
  300.  
  301.  
  302.  
  303. 2.4    Edit Menu and Editing Controls
  304.  
  305. UW/WIN works with the standard Windows clipboard and follows the standard Windows 
  306. paradigm for editing functions, plus some enhance|ments.
  307.  
  308. You may select text within the window by clicking and dragging the left mouse button. 
  309. The selected text becomes highlighted. The text may be copied to the clipboard by either 
  310. selecting "Edit | Copy", or by pressing Ctrl+Ins.
  311.  
  312. You may paste text into a UW window (the text basically gets sent over the modem) by 
  313. selecting "Edit | Paste", clicking the right mouse button, or using Shift+Ins.
  314.  
  315. An additional function is "Edit | Copy then Paste" which will copy the selected text and 
  316. paste it in in one operation. Useful for repeating previous commands. This may be per-
  317. formed by simply clicking the right mouse button.
  318.  
  319. 2.5    Setup Menu
  320.  
  321. There are four items in the setup menu.
  322.  
  323. 2.5.1    Setup Comm
  324.  
  325. This function brings up a dialog box allowing you to specify the communications parame-
  326. ters for the session. In Windows 3.0, the maximum baud rate is 19200 baud, where it is 
  327. 56K in Windows 3.1.
  328.  
  329. 2.5.2    Setup Initialization
  330.  
  331. Selecting this menu item brings up a dialog box that allows you to specify several initial-
  332. ization strings. The first is "Dial Prefix" This is the prefix to send to your modem for dial-
  333. ing. Usually it is "atdt". The second is "Modem Init String". This is the string to send to 
  334. the modem when the ".UW" file is loaded, and can also be sent via the "UW | Init" menu. 
  335. You would put in specific modem setups here, like protocol settings, etc. The third field 
  336. under Init is the "UW Command String" which specifies the string to send to start the 
  337. "UW" server, normally this is "uw^m". The last field sets the vt100 answerback string that 
  338. theUW/WIN will send when using vt100 emulation and it receives the request to send the 
  339. answerback string (^E).
  340.  
  341. 2.5.3    Setup Emulation
  342.  
  343. Selecting this menu item brings up a dialog box allowing you to select the desired emula-
  344. tion to use for both protocol 0 and protocol 1.
  345.  
  346. 2.5.4    Setup Preferences
  347.  
  348. Selecting this menu item brings up a dialog box allowing you to select some default pref-
  349. erences, including default font and screen size.
  350.  
  351. The "Batch Scroll" option may be useful when using slow graphics cards by allowing the 
  352. system to batch invalid regions before repainting. When using accelerated video cards, 
  353. this should be off (unchecked).
  354.  
  355. The VT100 answerback message is sent to the host in response to a ^E from the host (in 
  356. vt100 emulation).
  357.  
  358. 2.6    Dial Menu
  359.  
  360. The Dial menu has two items related to dialing.
  361.  
  362. 2.6.1    Number
  363.  
  364. This brings up the dial dialog allowing you to enter the phone number, and initiate dialing. 
  365. Once connected, the connection speed is displayed, and the dialog box disappears. If no 
  366. connection is made in the dial timeout, the dialog box resets. If UW/WIN was unable to 
  367. initialize the modem, a message box is brought up allowing you to "Abort, Retry, or 
  368. Ignore". Selecting "Retry" will attempt to communicate with the modem again. Ignore 
  369. will bypass initialization and go to dialing. Abort will stop the dialing process.
  370.  
  371. If the number is busy, UW/WIN will count down the redial delay that can be setup in the 
  372. "Setup | Comm" dialog, and redial the number again. Press cancel to abort re-dialing. If 
  373. the redial delay is 0, redial is disabled.
  374.  
  375. 2.6.2    Hangup
  376.  
  377. This will cause the modem to hangup, first by dropping DTR, and if that fails, it will use 
  378. the standard æ+++Æ escape string followed by "ath0" to hangup.
  379.  
  380. 2.7    Function Keys and Key Mapping
  381.  
  382. There are several customizations that you may make to the way the keyboard behaves. In 
  383. addition, you may program custom strings for each of the 10 standard functions keys.
  384.  
  385. These features may be programmed via the "Keys" menu item. Under this menu are two 
  386. items, "Function" and "Mappings". Each one will bring up as dialog box allowing you to 
  387. make changes to the behavior. In the "Function" dialog, you select which function key to 
  388. view/modify by selecting the appropriate radio button. You may edit the text, using the æ^Æ 
  389. character in combination with other ASCII characters to specify a control character. For 
  390. example, the character combination "^m" will be translated to the carriage return character 
  391. when you press that function key. After modifying the string for a particular function key, 
  392. you must press the "Save" button for the change to be recorded.
  393.  
  394. In the "Mappings" dialog, there is currently only one selection, "BS=DEL". When this 
  395. check box is checked, the backspace key will output the DEL code (0x7f) rather than the 
  396. BS code (0x08).
  397.  
  398. 2.8    UW Menu
  399.  
  400. The UW menu provides a menu interface to common UW functions.
  401.  
  402. 2.8.1    Quit - Quit UW/WIN. You will be prompted before quitting.
  403.  
  404. 2.8.2    Protocol-0 - Exit the UW protocol, killing all but window 1. You are prompted first.
  405.  
  406. 2.8.3    Break - Send a serial line break. Usually used to get the attention of the remote syste.
  407.  
  408. 2.8.4    Create - Create a new window (protocol 1 only).
  409.  
  410. 2.8.5    Remove - Remove the window (protocol 1 only).
  411.  
  412. 2.8.6    Init - Send the Initialization string.
  413.  
  414. 2.8.7    Start UW - Send the UW string to start the UW server.
  415.  
  416. 2.8.8    Upload - (Not yet implemented)
  417.  
  418. 2.8.9    Download - Begin a file download. See chapter 3.1 on downloading. This menu pulls right 
  419. to reveal three choices, Xmodem, Ymodem, and Zmodem.
  420.  
  421. 2.9    Fonts Menu
  422.  
  423. This menu has two selections. "Default" selects the default font (the one specified in 
  424. "Setup | Preferences".), and "Select", which bring up a font selection dialog box. The font 
  425. selected has immediate effect for the current window.
  426.  
  427. 2.10    Help Menu
  428.  
  429. Use this to access the help file.
  430.  
  431. 3.0    Config File Format
  432.  
  433. This section describes the meanings of the various settings that may appear in the ".UW" 
  434. config file. The syntax is "KEYWORD=value".
  435.  
  436. o    Fn_KEY : Where n is a number between 1 and 12. Defines the string to assign to 
  437. the function key ænÆ. All characters up to the end of the line make up the 
  438. string.
  439.  
  440. o    DEFAULT_FONT: Specifies the font specification for the default font. Generally 
  441. this is non-sensical and it is not recommended that this be modified 
  442. manually. Selecting the default font from the "Setup | Preferences" and 
  443. saving the config file will save the proper syntax.
  444.  
  445. o    MODEMINIT : Specifies the string for modem initialization. Set via the "Setup | 
  446. Init" dialog.
  447.  
  448. o    DIALPREFIX : Specifies the dial string for the modem. Set via the "Setup | Init" 
  449. dialog.
  450.  
  451. o    UWCOMMAND : Specifies the command to start the UW server. Set via the 
  452. "Setup | Init" dialog.
  453.  
  454. o    PHONENUMBER : The default phone number to dial. This is the last number 
  455. entered in the "Dial | Number" dialog before saving.
  456.  
  457. o    P0EMULATION 
  458.  
  459. o    P1EMULATION : Selects the terminal emulation for the specified protocol (0 or 
  460. 1).
  461.  
  462. o    BAUDRATE : Sets the comm port baud rate. Set via the "Setup | Comm" dialog. 
  463. Valid values are 300, 1200, 2400, 4800, 9600, 19200, 38400, and 
  464. 57600.
  465.  
  466. o    DATASIZE : Sets the data width for the comm port. Set via the "Setup | Comm" 
  467. dialog. Valid values are 7 or 8.
  468.  
  469. o    FLOWCONTROL : Sets the flow control type. Set via the "Setup | Comm" dialog. 
  470. Valid values are HARDWARE and SOFTWARE.
  471.  
  472. o    PARITY : Specifies the type of parity for the comm port. Set via the "Setup | 
  473. Comm" dialog. Valid values are EVEN, MARK, SPACE, NONE and 
  474. ODD.
  475.  
  476. o    BSKEY_MAP : If set to 1, then the Backspace key generates the "DEL" code 
  477. (0x7f) instead of the "BS" code (0x8). This can be set in the "Keys | 
  478. Mappings" dialog.
  479.  
  480. o    BATCH_SCROLL : If set, then invalid regions in the client area uncovered by 
  481. scrolling are batched together for a later repaint. This can be specified 
  482. in the "Setup | Preferences" dialog.
  483.  
  484. o    WINDOW_WIDTH :
  485.  
  486. o    WINDOW_HEIGHT : Specifies the default window size in characters. This can be 
  487. set in the "Setup | Preferences" dialog.
  488.  
  489. o    COMPORT : Specifies the comm port to use. This is selected via the "Setup | 
  490. Comm" dialog.
  491.  
  492. o    REDIALDELAY : Set the delay before the number is re-dialed if busy. If set to 0, 
  493. then redial is disabled. This is set in the "Setup | Comm" dialog.
  494.  
  495. o    ANSWERBACK : Sets the vt100 answerback message that UW/WIN will respond 
  496. with if in vt100 emulation, and a æ^EÆ is received. This can be set via 
  497. the "Setup | Init" dialog.
  498.  
  499. o    CONNECTDELAY : Sets the time to wait during dialing for a modem response 
  500. (NO CARRIER, etc) before aborting the connection. Can be set in the 
  501. "Setup | Comm" dialog.
  502.  
  503. o    HISTORYLINES : Sets the number of lines for the scrollback buffer. This can 
  504. only be set via the config file.
  505.  
  506. o    MULTIPLE_QUERY : When downloading files using Ymodem or Zmodem, hav-
  507. ing this set (1) will prompt for continuation between multiple files. 
  508. When reset (0), confirmation is only asked for the first file of a multiple 
  509. file transfer.
  510.  
  511. 4.0    File Downloading
  512.  
  513. UW/WIN has the capability to download files from the UNIX host using popular proto-
  514. cols. Three protocols are currently implemented, Xmodem, Ymodem, and Zmodem. Zmo-
  515. dem is by far the fastest and most popular. Using UWÆs unique modem multiplexing, it is 
  516. possible to download in more than one window at a time in protocol 1.
  517.  
  518. To perform downloads, a companion protocol program must be used on the UNIX host. 
  519. The most popular is Chuck Forsbergs rzsz package, available from many ftp sites. UW/
  520. WIN works reliably in testing with version 3.18.
  521.  
  522. In order to achieve reliable file transfers, you MUST have a solid modem connection with 
  523. error correction (MNP4 or V.42) using hardware flow control.
  524.  
  525. Zmodem transfers (sz) are detected automatically by UW/WIN which will pop the file 
  526. download dialog box with no manual interaction. Use the dialog box to navigate the disk 
  527. directories to select a directory to download into. Note that the rzsz package has a timeout 
  528. of 60 seconds, so you must make your selection promptly. Xmodem and Ymodem is not 
  529. detected automatically, so after issuing the send command on the UNIX host (sx or sb), 
  530. you must select "UW | Download -> [XY]modem". When using Zmodem or Ymodem, the 
  531. file name is sent by the sender, all you need do is pick the directory. Non DOS file names 
  532. (8.3) are truncated and massaged to conform. Xmodem requires you to enter a destination 
  533. filename as well.
  534.  
  535. There are some options available for downloading, the first, Multiple Query, is only valid 
  536. with Zmodem and Ymodem. When set, if multiple files are being sent by the sender, then 
  537. the user is prompted to click the "Start" button for each file. When unchecked, all files will 
  538. be transferred with no further interaction required.
  539.  
  540. The other option pertains to Xmodem transfers and selects whether CRC or Checksum 
  541. error detection is to be used.
  542.  
  543. As the file is transferred, status windows indicate progress, including size and % complete 
  544. (Zmodem and Ymodem only), received bytes, and transfer rate.
  545.  
  546. Note that when downloading in protocol 1, transfer rates will likely be less than under pro-
  547. tocol 0, especially for binary files. This is because the UW protocol escapes some control 
  548. characters, and characters above 127. This adds to the modem overhead. It does have the 
  549. advantage of running over 7 bit lines though, where other comm programs cannot.
  550.  
  551. 5.0    Emulation
  552.  
  553. UW/WIN supports three different types of emulation, adm31, vt52, and vt100. Vt100 
  554. emulation is the most widely supported, and is the focus of this chapter. The features in 
  555. vt100 emulation have been verified using "vttest" version 1.7b. This test is available by 
  556. request from me, or from various ftp sites.
  557.  
  558. 5.1    VT100 Support
  559.  
  560. UW/WIN vt100 emulation supports the full functionality of a vt102 terminal with some 
  561. minor restrictions. In order to get the most functionality from vt100 emulation, you must 
  562. use the supplied font file, vt100.fon, and have one of the vt100 fonts selected. Normally, 
  563. you should use the VT100 font. The other fonts are selected automatically depending on 
  564. the various modes, like 132 column, bold, line drawing, etc.
  565.  
  566. 5.2    Terminal Reports
  567.  
  568. In response to the "What Are You" report request, UW/WIN will respond with the 
  569. sequence "ESC[?1;2c" which means VT100 with AVO (Advanced Video Option) or 
  570. VT102.
  571.  
  572. When asked to report terminal parameters, UW/WIN will report the xmit and recv speed 
  573. as 19200 if the actual baud rate setting is 19200 or greater. Thevt100 spec has no provision 
  574. for reporting baud rates greater than 19200.
  575.  
  576. In response to the "Report Terminal Status" request, UW/WIN will always respond with 
  577. "ESC[0n" which means terminal OK.
  578.  
  579. 5.3    Colors
  580.  
  581. UW/WIN uses the following colors designation. You can change the colors by using the 
  582. system control panel to bring up the color dialog
  583.  
  584. o    Window Background color for the text background.
  585.  
  586. o    Window Text color for the text.
  587.  
  588. o    Highlight Text for the color of text highlighted by the mouse.
  589.  
  590. 5.4    Limitations
  591.  
  592. There are some aspects of vt100 emulation that are not supported due to technical difficul-
  593. ties in the Windows environment, and are rarely used. If these are very important to you, 
  594. contact me, and if enough interest is shown, I may consider adding some support.
  595.  
  596. The features not supported are.
  597.  
  598. o    Smooth Scroll - This rarely used feature would provide a smooth pixel by pixel scroll 
  599. instead of the usual line by line scroll. This feature is very slow, and 
  600. difficult to implement.
  601.  
  602. o    Double Wide/Double High characters - This is not supported.
  603.  
  604. o    Blinking characters - Blinking text is not practical in Windows. This attribute is emu-
  605. lated by using a strikethrough font.
  606.  
  607. All other features of vt100 and vt102 are supported including ANSI delete and insert char-
  608. acter. Escape codes for the unsupported features are recognized, but ignored.
  609.